Skip to content

chore: track the architecture-views.md staleness as issue #50, and measure the drift - #51

Merged
guycorbaz merged 1 commit into
masterfrom
chore-track-views-debt
Jul 29, 2026
Merged

chore: track the architecture-views.md staleness as issue #50, and measure the drift#51
guycorbaz merged 1 commit into
masterfrom
chore-track-views-debt

Conversation

@guycorbaz

Copy link
Copy Markdown
Owner

The architecture-views.md regeneration debt lived only in CLAUDE.md, docs/project-context.md and the sprint notes. This project's rule is that GitHub Issues are the single source of truth for work items outside the BMad story flow — so a milestone task tracked in prose was the one most likely to be forgotten, and it already had been: the milestone the notes named (the close of Epic 4) passed on 2026-07-25 without it.

Both notes now point at #50, and both carry what was measured rather than what was assumed.

What the measurement changed

claim before measured 2026-07-29
"STALE — regenerate at a milestone" drift is two commits, 59 insertions / 11 deletions
(implicit) a regeneration is a big job neither commit touches a decision body, a dissent or a renunciation — which is what the views file gathers
"DERIVED — never edit by hand. Regenerate from the source." there is no generator; cargo xtask exposes only ci, whose views-hash check merely verifies the frontmatter hash

The two commits are 7d4b1bd (the D65 post-completion section) and da23f9f (the source-tree diagram freshness pass, D64 fallout). The bulk of the real work is re-checking that the 883-line view file's line citations still resolve, since architecture.md grew by 236 lines — the file's whole contract is that it POINTS.

project-context.md's note also stops naming Epic 4's close as the milestone: a sentence describing a plan the project did not carry out reads as a fact and sends the next reader to the wrong place.

No code changes. cargo xtask ci green (ℹ views-hash STALE, exit 0 — still correct, and still the signal).

🤖 Generated with Claude Code

…asure the drift

The debt lived only in CLAUDE.md, docs/project-context.md and the sprint notes.
This project's own rule is that GitHub Issues are the single source of truth for
work items outside the BMad story flow, so a milestone task tracked in prose was
the one most likely to be forgotten — and it already had been: the milestone the
notes named (the close of Epic 4) passed on 2026-07-25 without it.

Both notes now point at #50, and both carry what was MEASURED rather than what
was assumed:

  · the drift is two commits, 59 insertions / 11 deletions — `7d4b1bd` (the D65
    post-completion section) and `da23f9f` (the source-tree diagram freshness
    pass). NEITHER touches a decision body, a dissent or a renunciation, which
    is what the views file gathers, so the content drift is smaller than the
    hash suggests;
  · there is NO generator. `cargo xtask` exposes only `ci`, whose views-hash
    check merely VERIFIES the frontmatter hash. "DERIVED — never edit by hand"
    has always meant "not independently of the source", not "a tool does it";
  · the bulk of the real work is re-checking that the 883-line view file's line
    citations still resolve, since architecture.md grew by 236 lines.

project-context.md's note also stops naming Epic 4's close as the milestone: a
sentence that describes a plan the project did not carry out reads as a fact and
sends the next reader to the wrong place.

No code changes. `cargo xtask ci` green.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@guycorbaz
guycorbaz merged commit 505379e into master Jul 29, 2026
1 check passed
@guycorbaz
guycorbaz deleted the chore-track-views-debt branch July 29, 2026 07:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant